Notes to self: to issue a new release
--------------------------------------
 1. Merge to develop
 2. Do 'make clean html' in docs
    - check API for missing doc files or func descriptions
 3. Test the build of 'develop' on readthedocs
 4. Update Release Notes section in README.rst
 5. Test setup.py installer on all three platforms
 6. Merge to master
 7. Increment version in version.py
 8. Commit in master to generate version tag
 9. Upload to pypi
10. Merge master back to develop etc.
11. Build doc on readthedocs.org
